home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 626-637 / disk_626 / iinfo / iinfo.doc < prev    next >
Text File  |  1992-05-06  |  6KB  |  180 lines
  1.  
  2. PROGRAM  
  3.         IInfo
  4.                                 
  5. SOURCE  
  6.     Written in 100% assembler using Macro68 V3.165.
  7.  
  8.  
  9. AUTHOR  Nic Wilson
  10.         Nic Wilson Software 
  11.         (Registered CBM (Aust) developer)
  12.         138d South Street
  13.         TOOWOOMBA QUEENSLAND 4350
  14.         Australia
  15.                                 
  16.         EMAIL cbmvax!cbmaus!wilson!nic@uunet.uu.net
  17.                  
  18.         or    cbmehq!cbmaus!wilson!nic@cbmvax.commodore.com
  19.                   
  20.         TELEPHONE +61 76 358539 After Hours Australian Time
  21.                   +61 76 358384 Work  Hours Australian Time
  22.         FAX       +61 76 358384 (Same as Work Telephone) 
  23.  
  24. FUNCTION
  25.  
  26.     A replacement for the DOS 'Info' command.  It takes
  27.     the same optional parameter but supplies more 
  28.     information than the DOS command.  Its main feature
  29.     is the display of the maximum file size that will
  30.     fit on a disk or drive, taking directory blocks
  31.     into account.
  32.     
  33.     The disk size, amount used and amount free are
  34.     displayed in Kilobyte or Megabyte rather than amount 
  35.     of blocks.  I beleive this is much more useful and 
  36.     less confusing to some users.
  37.         
  38.     All this bundled into a program using optimised
  39.     assembler that is smaller than the original DOS 
  40.     'Info' command. (Try that C programmers).
  41.         
  42. ACKNOWLEDGEMENTS
  43.  
  44.     Thank you to my friend Paul Coward (Digisoft) for 
  45.     a ...FAST assembler, Macro68 V3.  
  46.         
  47.     Thank you to Fred Fish for his continuing work in 
  48.     distribution of our programs.  Without his effort, 
  49.     distribution would be much more difficult if not
  50.     impossible.
  51.  
  52.                             
  53. COPYRIGHT
  54.  
  55.     This program, its source code and document files are 
  56.     (C) Copyright Nic Wilson Software 1992.  
  57.                 
  58. DISTRIBUTION
  59.  
  60.     Fred Fish is exempt from the distribution conditions
  61.     stated below.
  62.                 
  63.     The program is Shareware and may be freely distributed
  64.     on the condition that no profit is gained from this
  65.     distribution either directly or indirectly.  A small
  66.     copying fee, no more than the cost of 1 (one) average
  67.     3.5 inch blank disk or $2.50 Australian whichever is the
  68.     lesser.  
  69.                 
  70.     If this program is placed on a disk containing various 
  71.     utilities, the total charge for the disk MUST NOT BE
  72.     GREATER THAN 2 (two) average 3.5 inch blank disks or
  73.     $5.00 Australian whichever is the lesser.
  74.                 
  75.     Crunching of the executable file is considered a breach
  76.     of this agreement, due to the fact all current crunchers
  77.     I have tested either fail, or are unstable on the 68040 
  78.     CPU.  Archival in the form of 'lharc' type programs is 
  79.     permitted.  
  80.                                 
  81. DONATIONS
  82.  
  83.     All donations in the form of cash, money order,
  84.     travellers cheques, bank draft (in AUS dollars),
  85.     goods, software or hardware will be gratefully accepted,
  86.     and ensure further shareware programs from me.
  87.     Overseas users, please do not send personal cheques.  
  88.     It is very difficult to convert them into cash.
  89.                 
  90.     I give my sincere thanks to all those users who
  91.     have donated to my work in the past.  It is with
  92.     your continuing support to all programmers that the 
  93.     Amiga has such a vast amount of quality shareware 
  94.     programs available, and that I am able to continue 
  95.     work on shareware programs aswell as commercial ones.  
  96.                
  97.     If you are using my programs and haven't donated then
  98.     SHAME ON YOU.
  99.                  
  100.     All users who donate will receive a disk, full of
  101.     the latest versions of all my shareware programs.
  102.  
  103. REQUIREMENTS
  104.     Any Amiga
  105.     Any CPU 
  106.     Kickstart/Workbench 1.2 or greater.
  107.                 
  108. INSTALLING    
  109.         
  110.     IInfo should reside in your C: directory or be in your
  111.     path somewhere.  
  112.     
  113.     IInfo is pure and the pure bit should already be set
  114.     on the executable.  This means that IInfo can be made
  115.     resident.
  116.  
  117. VERSION 
  118.     You may always check the version of IInfo you are
  119.     using with the DOS 'version' command.
  120.  
  121. USAGE
  122.  
  123.     IInfo <device:>
  124.  
  125. <device:>       
  126.     An optional device name if you desire only this single
  127.     device to be displayed.  If this parameter is not given,
  128.     all devices found will be displayed.        
  129.         
  130. DISPLAYED FIELDS
  131.         
  132.     Unit     The name of the device.
  133.     Type     Type of file system  FFS = FastFileSystem
  134.                               OLD = OldFileSystem
  135.     Size     Total size.  Under 10 meg is shown in KiloBytes
  136.                       Over  10 meg is shown in MegaBytes
  137.     Used     Amount of space used, shown as for 'Size'.
  138.     Free     Amount of space free, shown as for 'Size'.
  139.     Max-File The maximum size file that will fit, shown in bytes.
  140.     Full     A percentage of the amount of space used.
  141.     Errs     Total number of software errors.
  142.     Stat     The status of the disk.  R/W  = Read/Write
  143.                        Read = Read Only
  144.                       VAL  = Validating
  145.     Name     The volume name of this disk.
  146.  
  147. NOTE ON FREE SPACE
  148.     
  149.     There can be times where a disk may have 1K free.
  150.     AmigaDOS will not allow a file to be written to
  151.     a disk that has two remaining blocks free.  These
  152.     two blocks could allow a file of 488 bytes for
  153.     the old file system or 512 bytes for fast file system
  154.     to be written, but I beleive that it may be a bug in 
  155.     AmigaDOS that prevents this.  The only other explanation
  156.     is that AmigaDOS may always require one free block, if
  157.     this is so I have no idea why!  IInfo has been coded to 
  158.     take this into account.  Therefore if a disk has two
  159.     or less remaining free blocks, Max-File will show zero. 
  160.  
  161.  
  162. VOLUMES AVAILABLE
  163.  
  164.     I have not implemented this function seperately
  165.     as the DOS 'Info' does.  I consider it to be redundant 
  166.     as mounted volumes and the volume names are already
  167.     displayed in the main listing.  The 'Info' command 
  168.     will display volume names that are still open by
  169.     the system if the disk has been ejected, but I do
  170.     not consider this information needed or useful. 
  171.  
  172. TRADEMARKS AND COPYRIGHTS
  173.                
  174.     Amiga and AmigaDOS are trademarks of Commodore Amiga Inc.
  175.     Macro68 is a trademark of DigiSoft.
  176.         
  177.                 
  178.                 
  179.                 
  180.